home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / dskut / unirfs15.zip / UNI-RFS.DOC < prev   
Text File  |  1993-10-21  |  10KB  |  220 lines
  1.                                   UNI-RFS 1.50
  2.                       (UniNova's Random File Selector)
  3.                   (c) 1993 by UniNova Services Corporation
  4.  
  5.  
  6. TABLE OF CONTENTS
  7. -----------------
  8.     What is RFS? ................................................... 1
  9.     Disclaimer ..................................................... 1
  10.     File List ...................................................... 1
  11.     How To... ...................................................... 2
  12.         Install RFS ................................................ 2
  13.         Run the RFS program ........................................ 2
  14.         Use RFS in a batch file .................................... 2
  15.             Sample batch file ...................................... 3
  16.     Copyright ...................................................... 3
  17.     Contacting UniNova ............................................. 4
  18.     Closing Notes .................................................. 4
  19.  
  20.  
  21. WHAT IS RFS?
  22. ------------
  23.  
  24. RFS is a simple program to randomly select from a group of files, and copy
  25. one file to a specific filename.  For example, by running RFS in the
  26. directory where one stores .BMP Windows wallpaper files, and having Windows
  27. use the wallpaper of "WINDOWS.BMP", one could randomly copy one .BMP file,
  28. from all available .BMP files, to the active wallpaper.  Called from the
  29. AUTOEXEC.BAT file, each reboot of the computer could lead to a different
  30. wallpaper.  RFS is free to use and copy, but it is NOT in the public domain.
  31. See the section COPYRIGHT in this document for specific information, and also
  32. see CONTACTING UNINOVA if you are interested in seeing the source code.
  33.  
  34.  
  35. DISCLAIMER
  36. ----------
  37.  
  38. By using RFS on your computer, you agree to assume full responsibility for
  39. the effects (or lack of effect) of the program on your system.  You agree to
  40. hold UniNova Services Corporation blameless and without liability, even in
  41. the event that some type of damage occurs.  RFS IS PROVIDED AS IS, WITH NO
  42. WARRANTY OR GUARANTEE, EXPRESS OR IMPLIED, OF ANY KIND.  This implicit agree-
  43. ment between you, the user, and UniNova Services Corporation is governed by
  44. the laws of the State of Delaware.
  45.  
  46.  
  47. FILE LIST
  48. ---------
  49.  
  50. The following files should appear in the distribution archive in which you
  51. received RFS (and which you should include for re-distribution):
  52.  
  53.     RFS.EXE         - The program executable code itself
  54.     UNI-RFS.DOC     - This document
  55.  
  56. If any of these files are missing, or you just want to make sure you have
  57. the most recent version, see "Contacting UniNova" for information on the
  58. UniNova Support BBS.
  59.  
  60.                                                                            
  61. HOW TO...
  62. ---------
  63.  
  64.     INSTALL RFS
  65.     -----------
  66.     If you are reading this, presumably you have already opened the archive
  67.     containing the RFS program.  If not, do so now.  You should place the
  68.     file RFS.EXE in a convenient location; by placing it in a directory that
  69.     is already in your DOS PATH, it will be available to you from any batch
  70.     file in any location.  (Please refer to your DOS manual if you need more
  71.     information on batch files and/or the PATH statement in DOS.)  Once you
  72.     have RFS placed in a convenient directory, you're done installing it!
  73.  
  74.     RUN THE RFS PROGRAM:
  75.     --------------------
  76.     Simply make a call to the program from the DOS prompt or batch file,
  77.     giving it two parameters.  The first is the file specification for the
  78.     set of files to copy from (presumably including at least one wildcard,
  79.     otherwise the COPY command in DOS would be more appropriate than RFS).
  80.     The second parameter is the name of the file that the selected file
  81.     is copied to.  The second parameter may match the first parameter's
  82.     file specification - RFS will simply skip over it.  Thus, the basic
  83.     syntax for RFS is:
  84.  
  85.     RFS  file*.spc filename.ext
  86.  
  87.     where "file*.spc" is the specification for the group of files, and
  88.     "filename.ext" is the file to copy to.  RFS is not case sensitive,
  89.     and will return the following errorlevels:
  90.         0 - program successful
  91.         1 - no parameters given
  92.         2 - missing 2nd parameter (destination filename)
  93.         3 - no files matching specification given in 1st parameter
  94.     (Please refer to your DOS manual for an explanation of errorlevels;
  95.     if you don't know what they are, and don't care what RFS sets the
  96.     errorlevel to, it won't do you any harm.)
  97.  
  98.     You can also make use of the "help" feature of RFS by calling it
  99.     with the single parameter containing a question mark to get a
  100.     quick usage reminder.  Therefore,
  101.  
  102.     RFS ?
  103.     RFS /?
  104.     RFS -?
  105.     (actually, even RFS HELP?!)
  106.  
  107.     will all work to display a short reminder on the correct syntax for the
  108.     program.
  109.     
  110.     USE RFS IN A BATCH FILE
  111.     -----------------------
  112.     You will probably want to put the call to RFS in a batch file so that
  113.     there is no need to run it manually (or even think about it, once it's
  114.     set up).  For example, calling it from the AUTOEXEC.BAT file will run
  115.     the program every time you boot up your computer, so you will have a
  116.     frequent change in Windows Wallpaper.  If you're not using RFS to change
  117.     your wallpaper, the batch file you add it to will vary.
  118.  
  119.     If you check for the errorlevel returned by RFS, make sure that you
  120.     start at the highest (3) and work down.  This is due to DOS evaluating  
  121.     ERRORLEVEL = n as "true" for values of n from n to positive infinity.
  122.     (In other words, if the errorlevel is 3, ERRORLEVEL = 2 is "true", as
  123.     far as DOS is concerned.)
  124.  
  125.     The following sample batch file is an example of an AUTOEXEC.BAT file
  126.     that calls RFS at the end to change the current Windows wallpaper:
  127.  
  128.         @ECHO OFF
  129.         REM This is a sample AUTOEXEC batch file, which would be run 
  130.         REM every time you boot your computer.  The important line here
  131.         REM is line 14 (comments included), but the rest is at least semi-
  132.         REM relevant.
  133.         PATH C:\;C:\DOS;C:\WINDOWS;C:\UTIL
  134.         REM We will assume that RFS.EXE is located in C:\UTIL, part of the
  135.         REM list of DOS PATH directories, and your .BMP files are on CD-ROM
  136.         REM drive F in the \WINDOWS\WALLP directory.
  137.         PROMPT $P$G
  138.         CD \WINDOWS
  139.         REM We will also assume that the wallpaper set in the Windows
  140.         REM Control Panel, Desktop, is "WINDOWS.BMP".
  141.         RFS F:\WINDOWS\WALLP\*.BMP WINDOWS.BMP
  142.         IF ERRORLEVEL 1 GOTO BMPERR
  143.         GOTO END
  144.         :BMPERR
  145.         ECHO NOTICE!  The RFS program reported an error condition!
  146.         :END
  147.  
  148.     This is just a sample for one way to use RFS in a batch file.  If you
  149.     run a BBS, you could also use it to randomize your screens.  You will
  150.     certainly find other uses for the program!
  151.  
  152.  
  153. COPYRIGHT
  154. ---------
  155.  
  156. Although RFS is free to use, it is not public domain software!  All rights
  157. to RFS are reserved by UniNova Services Corporation.  You are given the
  158. following specific permissions (license), any or all of which may be revoked
  159. at any time:
  160.  
  161.     1.  You may copy, distribute, and use RFS without charge, IF AND ONLY
  162.     IF:
  163.         a) You include all documentation files you received with the copies
  164.         you distribute; and,
  165.         b) You do NOT modify the program or documentation in any way,
  166.         including (but not limited to) removing the copyright notice; and,
  167.         c) You notify the recipient of the copies you distribute that they
  168.         do not own the program but merely have free license to use it in
  169.         the manner outlined in this section.
  170.  
  171.     2.  You may incorporate RFS in your own hardware or software applications
  172.     without royalty, IF AND ONLY IF you obtain written permission from UniNova
  173.     Services Corporation IN ADVANCE.  If you incorporate it in a system
  174.     without prior written permission, you are subject to payment of penalty
  175.     fees and continuing royalties; compared with getting the permission in
  176.     advance, it's not wor